<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><meta http-equiv="Content-Language" content="zh-CN"><title>systemd-firstboot
  中文手册 [金步国]</title><style>
@font-face { font-family: "JinBuGuoWebMono"; src: url("http://www.jinbuguo.com/d/mono.ttf") format("truetype"); }
* { font-family: "JinBuGuoWebMono", "Ubuntu Mono", "Consolas", "Menlo", monospace; }
body { margin:10px; }
h1 { text-align:center; background:#ddd; }
h2#auth_name { text-align:center; margin: 10px 5%; }

    a.headerlink {
      color: #c60f0f;
      font-size: 0.8em;
      padding: 0 4px 0 4px;
      text-decoration: none;
      visibility: hidden;
    }

    a.headerlink:hover {
      background-color: #c60f0f;
      color: white;
    }

    h1:hover > a.headerlink, h2:hover > a.headerlink, h3:hover > a.headerlink, dt:hover > a.headerlink {
      visibility: visible;
    }
</style><script> var _hmt = _hmt || []; (function() { var hm = document.createElement("script"); hm.src = "https://hm.baidu.com/hm.js?d286c55b63a3c54a1e43d10d4c203e75"; var s = document.getElementsByTagName("script")[0]; s.parentNode.insertBefore(hm, s); })(); </script></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><h1>systemd-firstboot 中文手册</h1><h2 id="auth_name">译者：<strong><a href="http://www.jinbuguo.com/">金步国</a></strong></h2><hr><h3>版权声明</h3><p>本文译者是一位开源理念的坚定支持者，所以本文虽然不是软件，但是遵照开源的精神发布。</p><ul><li>无担保：本文译者不保证译文内容准确无误，亦不承担任何由于使用此文档所导致的损失。</li><li>自由使用：任何人都可以自由的<u>阅读/链接/打印</u>此文档，无需任何附加条件。</li><li>名誉权：任何人都可以自由的<u>转载/引用/再创作</u>此文档，但必须保留译者署名并注明出处。</li></ul><h3>其他作品</h3><p>本文译者十分愿意与他人分享劳动成果，如果你对我的其他翻译作品或者技术文章有兴趣，可以在如下位置查看现有的作品集：</p><ul><li><a href="http://www.jinbuguo.com/">金步国作品集</a> [ <a href="http://www.jinbuguo.com/">http://www.jinbuguo.com/</a> ]</li></ul><h3>联系方式</h3><p>由于译者水平有限，因此不能保证译文内容准确无误。如果你发现了译文中的错误(哪怕是错别字也好)，请来信指出，任何提高译文质量的建议我都将虚心接纳。</p><ul><li>Email(QQ)：70171448在QQ邮箱</li></ul><hr><a href="systemd.index.html">手册索引</a> ·
  <a href="systemd.directives.html">指令索引</a><span style="float:right">systemd-241</span><hr><div class="refentry"><a name="systemd-firstboot"></a><div class="titlepage"></div><div class="refnamediv"><h2>名称</h2><p>systemd-firstboot, systemd-firstboot.service — 初始化基本系统设置</p></div><div class="refsynopsisdiv"><h2>大纲</h2><div class="cmdsynopsis"><p><code class="command">systemd-firstboot</code>  [OPTIONS...]</p></div><p><code class="filename">systemd-firstboot.service</code></p></div><div class="refsect1"><a name="id-1.5"></a><h2 id="描述">描述<a class="headerlink" title="Permalink to this headline" href="systemd-firstboot.html#%E6%8F%8F%E8%BF%B0">¶</a></h2><p><span class="command"><strong>systemd-firstboot</strong></span>
    既可以在系统首次启动时交互式的初始化最基本的系统设置，
    也可以在创建新系统镜像时非交互式的初始化最基本的系统设置。
    该服务将在 <code class="varname">ConditionFirstBoot=yes</code> 时启动。
    这意味着当时的 <code class="filename">/etc</code> 目录处于尚未初始化的状态。
    详见
    <a href="systemd.unit.html#"><span class="citerefentry"><span class="refentrytitle">systemd.unit</span>(5)</span></a>
    手册。</p><p>这些最基本的系统设置包括：</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>本地化，
      也就是 <code class="varname">LANG=</code> 与
      <code class="varname">LC_MESSAGES</code> 两个环境变量。</p></li><li class="listitem"><p>键盘映射</p></li><li class="listitem"><p>时区</p></li><li class="listitem"><p>主机名</p></li><li class="listitem"><p>"machine ID"</p></li><li class="listitem"><p>root 用户的密码</p></li></ul></div><p>所有上述设置既可以交互式的向用户询问，
    也可以非交互式的通过命令行选项指定，
    还可以从创建新系统镜像的主机
    复制而来。</p><p>如果某个设置已经被初始化，
    那么将不会覆盖已有的设置，
    并且不会提示用户设置此项。</p><p>此工具
    与
    <a href="localectl.html#"><span class="citerefentry"><span class="refentrytitle">localectl</span>(1)</span></a>,
    <a href="timedatectl.html#"><span class="citerefentry"><span class="refentrytitle">timedatectl</span>(1)</span></a>,
    <a href="hostnamectl.html#"><span class="citerefentry"><span class="refentrytitle">hostnamectl</span>(1)</span></a>
    不同，它直接操作文件系统上的配置文件，并且不需要任何系统服务的支持。
    因此， <span class="command"><strong>systemd-firstboot</strong></span>
    可用于设置一个已挂载(但未启动)的系统镜像。
    不应该在运行中的系统上使用 <span class="command"><strong>systemd-firstboot</strong></span>
    命令。</p></div><div class="refsect1"><a name="id-1.6"></a><h2 id="选项">选项<a class="headerlink" title="Permalink to this headline" href="systemd-firstboot.html#%E9%80%89%E9%A1%B9">¶</a></h2><p>能够识别的命令行选项如下：</p><div class="variablelist"><dl class="variablelist"><dt id="--root=root"><span class="term"><code class="option">--root=<em class="replaceable"><code>root</code></em></code></span><a class="headerlink" title="Permalink to this term" href="systemd-firstboot.html#--root=root">¶</a></dt><dd><p>指定已挂载(但未启动)的系统镜像的根目录位置，
        所有其他路径都将以此
        <em class="replaceable"><code>root</code></em> 为前缀。
        仅在为已挂载(但未启动)的系统镜像
        初始化基本系统参数时才需要使用此选项。
        </p></dd><dt id="--locale=LOCALE"><span class="term"><code class="option">--locale=<em class="replaceable"><code>LOCALE</code></em></code>, </span><span class="term"><code class="option">--locale-messages=<em class="replaceable"><code>LOCALE</code></em></code></span><a class="headerlink" title="Permalink to this term" href="systemd-firstboot.html#--locale=LOCALE">¶</a></dt><dd><p>分别设置
        <code class="varname">LANG=</code> 与 <code class="varname">LC_MESSAGES</code>
        环境变量。
        例如 "<code class="literal">zh_CN.utf8</code>" 。此选项用于设置
        <a href="locale.conf.html#"><span class="citerefentry"><span class="refentrytitle">locale.conf</span>(5)</span></a>
        配置文件。</p></dd><dt id="--keymap=KEYMAP"><span class="term"><code class="option">--keymap=<em class="replaceable"><code>KEYMAP</code></em></code></span><a class="headerlink" title="Permalink to this term" href="systemd-firstboot.html#--keymap=KEYMAP">¶</a></dt><dd><p>设置系统的键盘布局。参数必须是一个例如
         "<code class="literal">de-latin1</code>" 这样有效的键盘映射名称(中文用户推荐使用"us")。此选项用于设置
        <a href="http://man7.org/linux/man-pages/man5/vconsole.conf.5.html"><span class="citerefentry"><span class="refentrytitle">vconsole.conf</span>(5)</span></a>
        配置文件中 "<code class="literal">KEYMAP</code>" 的值。</p></dd><dt id="--timezone=TIMEZONE"><span class="term"><code class="option">--timezone=<em class="replaceable"><code>TIMEZONE</code></em></code></span><a class="headerlink" title="Permalink to this term" href="systemd-firstboot.html#--timezone=TIMEZONE">¶</a></dt><dd><p>设置系统时区。
        例如
        "<code class="literal">PRC</code>" (北京时间)。此选项用于设置
        <a href="localtime.html#"><span class="citerefentry"><span class="refentrytitle">localtime</span>(5)</span></a>
        软连接的指向。</p></dd><dt id="--hostname=HOSTNAME"><span class="term"><code class="option">--hostname=<em class="replaceable"><code>HOSTNAME</code></em></code></span><a class="headerlink" title="Permalink to this term" href="systemd-firstboot.html#--hostname=HOSTNAME">¶</a></dt><dd><p>设置主机名。
        此选项用于设置
        <a href="hostname.html#"><span class="citerefentry"><span class="refentrytitle">hostname</span>(5)</span></a>
        配置文件。</p></dd><dt id="--machine-id=ID"><span class="term"><code class="option">--machine-id=<em class="replaceable"><code>ID</code></em></code></span><a class="headerlink" title="Permalink to this term" href="systemd-firstboot.html#--machine-id=ID">¶</a></dt><dd><p>设置"machine ID"。
        此选项用于设置
        <a href="machine-id.html#"><span class="citerefentry"><span class="refentrytitle">machine-id</span>(5)</span></a>
        文件。</p></dd><dt id="--root-password=PASSWORD"><span class="term"><code class="option">--root-password=<em class="replaceable"><code>PASSWORD</code></em></code>, </span><span class="term"><code class="option">--root-password-file=<em class="replaceable"><code>PATH</code></em></code></span><a class="headerlink" title="Permalink to this term" href="systemd-firstboot.html#--root-password=PASSWORD">¶</a></dt><dd><p>设置root用户的密码，
        同时创建
        <a href="https://linux.die.net/man/5/shadow"><span class="citerefentry"><span class="refentrytitle">shadow</span>(5)</span></a>
        文件。既可以通过
        <code class="option">--root-password=</code> 选项直接在命令行上指定密码，
        也可以通过
        <code class="option">--root-password-file=</code> 选项从指定的文件中读取密码。
        出于安全考虑，
        一般不建议直接在命令行上指定密码，
        因为其他用户可以通过
        <a href="https://linux.die.net/man/1/ps"><span class="citerefentry"><span class="refentrytitle">ps</span>(1)</span></a> 命令看到密码。</p></dd><dt id="--prompt-locale"><span class="term"><code class="option">--prompt-locale</code>, </span><span class="term"><code class="option">--prompt-keymap</code>, </span><span class="term"><code class="option">--prompt-timezone</code>, </span><span class="term"><code class="option">--prompt-hostname</code>, </span><span class="term"><code class="option">--prompt-root-password</code></span><a class="headerlink" title="Permalink to this term" href="systemd-firstboot.html#--prompt-locale">¶</a></dt><dd><p>以交互式对话
        询问用户特定的设置，
        但不会提示已经在命令行上指定的设置
        (因为它们的优先级更高)。</p></dd><dt id="--prompt"><span class="term"><code class="option">--prompt</code></span><a class="headerlink" title="Permalink to this term" href="systemd-firstboot.html#--prompt">¶</a></dt><dd><p>以交互式对话询问用户本地化、键盘映射、时区、主机名、root密码。
        相当于同时使用
        <code class="option">--prompt-locale</code>,
        <code class="option">--prompt-keymap</code>,
        <code class="option">--prompt-timezone</code>,
        <code class="option">--prompt-hostname</code>,
        <code class="option">--prompt-root-password</code> 选项。</p></dd><dt id="--copy-locale"><span class="term"><code class="option">--copy-locale</code>, </span><span class="term"><code class="option">--copy-keymap</code>, </span><span class="term"><code class="option">--copy-timezone</code>, </span><span class="term"><code class="option">--copy-root-password</code></span><a class="headerlink" title="Permalink to this term" href="systemd-firstboot.html#--copy-locale">¶</a></dt><dd><p>从主机复制特定的设置，
        必须和 <code class="option">--root=</code>
        选项一起使用。</p></dd><dt id="--copy"><span class="term"><code class="option">--copy</code></span><a class="headerlink" title="Permalink to this term" href="systemd-firstboot.html#--copy">¶</a></dt><dd><p>从主机复制本地化、键盘映射、时区、root密码。
        必须和 <code class="option">--root=</code> 选项一起使用。相当于同时使用
        <code class="option">--copy-locale</code>,
        <code class="option">--copy-keymap</code>,
        <code class="option">--copy-timezone</code>,
        <code class="option">--copy-root-password</code> 选项。</p></dd><dt id="--setup-machine-id"><span class="term"><code class="option">--setup-machine-id</code></span><a class="headerlink" title="Permalink to this term" href="systemd-firstboot.html#--setup-machine-id">¶</a></dt><dd><p>将"machine ID"初始化为一个随机值。
        必须和
        <code class="option">--root=</code> 选项一起使用。</p></dd><dt id="-h"><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span><a class="headerlink" title="Permalink to this term" href="systemd-firstboot.html#-h">¶</a></dt><dd><p><a name="help-text"></a>显示简短的帮助信息并退出。
    </p></dd><dt id="--version"><span class="term"><code class="option">--version</code></span><a class="headerlink" title="Permalink to this term" href="systemd-firstboot.html#--version">¶</a></dt><dd><p><a name="version-text"></a>显示简短的版本信息并退出。</p></dd></dl></div></div><div class="refsect1"><a name="id-1.7"></a><h2 id="退出状态">退出状态<a class="headerlink" title="Permalink to this headline" href="systemd-firstboot.html#%E9%80%80%E5%87%BA%E7%8A%B6%E6%80%81">¶</a></h2><p>返回值为 0 表示成功，
    非零返回值表示失败代码。</p></div><div class="refsect1"><a name="id-1.8"></a><h2 id="内核引导选项">内核引导选项<a class="headerlink" title="Permalink to this headline" href="systemd-firstboot.html#%E5%86%85%E6%A0%B8%E5%BC%95%E5%AF%BC%E9%80%89%E9%A1%B9">¶</a></h2><div class="variablelist"><dl class="variablelist"><dt id="systemd.firstboot="><span class="term"><code class="varname">systemd.firstboot=</code></span><a class="headerlink" title="Permalink to this term" href="systemd-firstboot.html#systemd.firstboot=">¶</a></dt><dd><p>设置是否为首次启动。默认值为 "yes" 。
        如果设为 "no" ，那么即使系统实际上是首次启动并且没有进行过任何初始化设置，
        <code class="filename">systemd-firstboot.service</code> 也不会要求用户对系统进行基本的初始化设置。</p></dd></dl></div></div><div class="refsect1"><a name="id-1.9"></a><h2 id="参见">参见<a class="headerlink" title="Permalink to this headline" href="systemd-firstboot.html#%E5%8F%82%E8%A7%81">¶</a></h2><p>
      <a href="systemd.html#"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>,
      <a href="http://man7.org/linux/man-pages/man5/locale.conf.5.html"><span class="citerefentry"><span class="refentrytitle">locale.conf</span>(5)</span></a>,
      <a href="http://man7.org/linux/man-pages/man5/vconsole.conf.5.html"><span class="citerefentry"><span class="refentrytitle">vconsole.conf</span>(5)</span></a>,
      <a href="localtime.html#"><span class="citerefentry"><span class="refentrytitle">localtime</span>(5)</span></a>,
      <a href="hostname.html#"><span class="citerefentry"><span class="refentrytitle">hostname</span>(5)</span></a>,
      <a href="machine-id.html#"><span class="citerefentry"><span class="refentrytitle">machine-id</span>(5)</span></a>,
      <a href="https://linux.die.net/man/5/shadow"><span class="citerefentry"><span class="refentrytitle">shadow</span>(5)</span></a>,
      <a href="systemd-machine-id-setup.html#"><span class="citerefentry"><span class="refentrytitle">systemd-machine-id-setup</span>(1)</span></a>,
      <a href="http://man7.org/linux/man-pages/man1/localectl.1.html"><span class="citerefentry"><span class="refentrytitle">localectl</span>(1)</span></a>,
      <a href="timedatectl.html#"><span class="citerefentry"><span class="refentrytitle">timedatectl</span>(1)</span></a>,
      <a href="hostnamectl.html#"><span class="citerefentry"><span class="refentrytitle">hostnamectl</span>(1)</span></a>
    </p></div></div></body></html>
